home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1994 November / macformat-018.iso / Comms Spectacular / QuickBDA folder / About QuickB DA.txt next >
Encoding:
Text File  |  1990-12-04  |  9.2 KB  |  213 lines  |  [TEXT/MACA]
  1.                                     QuickB DA
  2.                                     ------ --
  3.  
  4.                               v.1.0 of Dec. 4, 1990.
  5.                 QuickB Desk Accessory was written by Raymond Lau.
  6.                          Copyright 1988,89, Raymond Lau.
  7.  
  8.     QuickB Download is shareware. Try it a few times. If you like it, find
  9.    it useful, or save some money off your CompuServe bills, please register
  10.                        it by sending $15 to the author:
  11.  
  12.                                  Raymond Lau
  13.                                 100-04 70 Ave.
  14.                         Forest Hills, N. Y. 11375-5133
  15.                                    U. S. A.
  16.  
  17.            (Note: Registered QuickB Download users need not re-register.)
  18.  
  19.  
  20.                                  Introduction
  21.                                  ------------
  22.  
  23. QuickB DA is a desk accessory written for the CompuServe user who uploads and
  24. downloads frequently.  QuickB is a new protocol which allows for significant
  25. speed gains and time savings when up/downloading from CompuServe.  While some
  26. telecom programs are starting to support the QuickB protocol, many others
  27. do not.  With QuickB DA, you can take advantage of this protocol from within
  28. these telecommunications programs.
  29.  
  30.                            Relation to QuickB Download
  31.                            -------- -- ------ --------
  32.  
  33. Some of you may be familiar with my QuickB Download DA.  This is a direct
  34. successor to it.  This allows you to upload as well as download.
  35.  
  36.                                  Installation
  37.                                  ------------
  38.  
  39. To install QuickB DA, you should be familar with the operation of
  40. Apple's Font/DA Mover.  If you are not, please consult the appropriate
  41. documentation before continuing.
  42.  
  43. QuickB DA may be installed into the System file, where you can use
  44. it in any communications program, if you use more than one.  It may also
  45. be installed directly into your communications program(s) or Suitcase and
  46. Master Juggler, etc. files.
  47.  
  48.  
  49.  
  50.                                   Operation
  51.                                   ---------
  52.  
  53. Make sure your telecom program is set for 8 bits, no parity, 1 stop bit.
  54. If it is set for 7 bits, QuickB DA will not function properly.
  55.  
  56. Operation is very straight forward.
  57.  
  58. Initiate the QuickB upload or download process on CompuServe.
  59. For example, say you are browsing a file description and you want
  60. to download that file.   Just type "dow /proto:qb" at the prompt.  Or
  61. you can go through the menu system and pick the QuickB option...
  62.  
  63.  
  64. CompuServe will prompt you for a file name.  Type in an appropriate
  65. file name.  (This is the "primary" file name as will be explained
  66. later.)
  67.  
  68. Now, go to the Apple menu and select QuickB DA.  If you are running
  69. MultiFinder, you should also hold down the option key as you select
  70. QuickB and keep holding it down until the QuickB window comes up.
  71. (This launches QuickB under your telecom program's "layer" and prevents
  72. QuickB from competing with it for the serial port.)
  73.  
  74. After some negotiations with the CompuServe mainframe, you will be
  75. prompted either with a standard Save As dialog (for downloading) or a
  76. standard Open dialog (for uploading).  For downloading, you
  77. can select the destination folder to save the downloaded file.  For the
  78. file name, type in a filename.  (This is the "last choice" file name --
  79. to be explained shortly!)  Or just click Save to use the default.
  80.  
  81. That's all there is to it!  Now sit back and watch the file transfer
  82. proceed.
  83.  
  84.    [A small problem.  CIS isn't always too responsive.  If you see
  85.     that the download isn't beginning within a reasonable amount of
  86.     time, abort and try again.  Sometimes CIS is so overloaded that it
  87.     gets confused and goes "out of sync" at the beginning.]
  88.  
  89. (NOTE: When using Red Ryder, you must uncheck the Enable CIS 'B' option.
  90.  If you don't, Red Ryder will take over and CompuServe will think that you
  91.  want to use regular B rather than the extended QuickB with QuickB
  92.  Download.)
  93.  
  94.                                  File Naming
  95.                                  ---- ------
  96.  
  97. QuickB DA uses the following procedure when naming files on downloading:
  98.  
  99. For MacBinary Files:
  100. (including applications, DAs, FKEYs, MacWrite files, StuffIt archives,etc.)
  101.  
  102. • The original file name, the one the file was uploaded with, will be used
  103.     first.
  104. • If a file already exists by that name, the "last choice" file name
  105.     will be used.  This is the file name you typed into the dialog box
  106.     when you were prompted with the Save As dialog box.
  107.     (Since you selected this as the "last choice" name, if a file already
  108.      exists, it will be deleted and replaced.)
  109.     
  110.  
  111. For text and other non-MacBinary files:
  112. • The file name you typed in at the "Filename:" prompt will be used.
  113.     This is why this is referred to as the "primary" file name.
  114. • If a file already exists by that name, the last choice file name
  115.     will be used.  This is the file name you typed into the dialog box
  116.     when you were prompted with the Save As dialog box.
  117.     (Since you selected this as the "last choice" name, if a file already
  118.      exists, it will be deleted and replaced.)
  119.  
  120.  
  121. If this seems unneccessarily confusing, don't worry!  You don't have to
  122. memorize it per se... In most cases, this procedure would be what you
  123. would want intuitively.
  124.  
  125.  
  126.                                    Aborting
  127.                                    --------
  128.  
  129. Hold down the command and period keys until you hear a beep to abort the
  130. transfer process.  This works MOST of the time.  At times, CompuServe
  131. may not recognize the abort sequence sent by QuickB DA.  If you
  132. think CompuServe is hanging on you after you issued an abort and QuickB
  133. DA has closed itself, type in a sequence of four control-P's.
  134. Wait 3-5 seconds.  Repeat 2-4 times if needed.  Usually, this "Panic
  135. Abort" sequence is recognized if it is sent 3 times.  (It SHOULD be
  136. recognized the first time according to the CompuServe documentation, but
  137. in practice, it usually takes 3 panic abort sequences.)
  138.  
  139.  
  140.  
  141.                                Why No Background?
  142.                                --- -- -----------
  143.  
  144. You may ask why not have QuickB Download work in the background?  The
  145. answer is simple.  If I were to make it work in the background, it would
  146. require you to quit from your communications program before you can run
  147. QuickB DA or else the two would compete for the serial port...
  148.  
  149.  
  150.                                 Other Products
  151.                                 ----- --------
  152.  
  153. Other products I have written include (as of 12/4/90):
  154.  
  155. StuffIt Classic -- a file compression and archival program that allows
  156.      you to save disk space and file transmission time.  Your archives
  157.      are as flexible as the file system itself.  You can enter folders
  158.      saved within archives, add more files to and delete files from
  159.      existing archives...  As an added feature, your files can
  160.      optionally be scanned for currently known virrii as they're being
  161.      stuffed into or unstuffed from an archive.
  162.      ($25 shareware: available online and from Aladdin Systems, Inc.)
  163.      
  164. StuffIt Deluxe -- an enhanced version which includes support for
  165.                   viewing multiple archives at once, encryption,
  166.                   viewing files in an archive, copying and moving
  167.                   files within and amongst archives, perform common
  168.                   operations right from your Finder desktop with
  169.                   Magic Menu, etc.
  170.                   ($99.95 suggested retail available from many mail
  171.                    order sources and Aladdin.)
  172.  
  173. Shortcut -- a utility that greatly enhances your standard file Open
  174.             and Save As dialogs by allowing you to maintain lists of
  175.             commonly used files and folders and to access them with
  176.             a single flick of the mouse or a few key presses.  Other
  177.             features include creation of new folders, deletion of
  178.             files, finding lost files (including those in StuffIt
  179.             archives), unstuffing files...  and soon, access to
  180.             StuffIt archives from right within the Open dialog box,
  181.             ability to view certain files before opening them,
  182.             and more!
  183.             ($79.95 suggested retail available from many mail order
  184.              sources and Aladdin.)
  185.  
  186.  
  187. Aladdin Systems, Inc. may be reached at:
  188.  
  189. Deer Park Center, #23A-171
  190. Aptos, CA 95003-4723
  191. 408-685-9175
  192.  
  193. I may be reached at my address at the top of this document.
  194.  
  195.  
  196.                                QuickB Protocol
  197.                                ------ --------
  198. (For the technical types and the curious.  With editorial comments.)
  199.  
  200. CompuServe's QuickB protocol is an extension of their CIS B protocol.
  201. The version QuickB Download implements is current as of Jan. '88.
  202. It provides for a maximum packet size of 1024 bytes (1k) to reduce time
  203. spent in error checking.  It allows for a one packet send ahead facility.
  204. (otherwise known as sliding window or windowed.)  It uses XModem style
  205. CRC (bits reversed from CRC-CCITT standard) for error checking and
  206. correction.
  207.  
  208. It has the ability to fall back to smaller sized packets if the host
  209. doesn't support 1k packets.  It can also fall back to no send ahead and
  210. checksum error checking.  These capabilities are meant for communicating
  211. with someone using older versions of CompuServe's Vidtex communications
  212. software on other computers.  There isn't a version for the Mac that I
  213. know of.